home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat23 / filereq / filereq.doc < prev    next >
Encoding:
Text File  |  1998-08-04  |  4.6 KB  |  117 lines
  1.                         ############################
  2.                         #      FileReq v1.0        #
  3.                         #     Copyright 1993       #
  4.                         # Auteur: ROUSSEAU Yannick #
  5.                         ############################
  6.  
  7. I - PRESENTATION
  8. -----------------
  9.     FileReq est FREEWARE, mais il doit toujours être  accompagné de sa
  10. documentation.
  11.     FileReq permet  d'afficher  un File  Requester ASl dans un fichier
  12. de commandes  AmigaDOS, qui  de plus  est configurable  selon le désir
  13. de l'utilisateur; et ne marche qu'avec le Workbench 2.0.
  14.     Le passage de parametres  ne se fait pas à la suite de la commande
  15. FileReq, mais  par l'intermediaire  des Variables Locales spécifiques.
  16.     Vous obtiendrez le nom du fichier  sélectionné et  son chemin dans
  17. les variables locales ASL_File et ASL_Dir.
  18.     De plus ce programme peut être rendu résident.
  19.  
  20. II - DESCRIPTIF DES VARIABLES LOCALES RECONNUES PAR FILEREQ
  21. ------------------------------------------------------------
  22.  
  23.     Il  n'est pas  obligatoire  de définir  toutes ces variables avant
  24. d'utiliser FileReq.
  25.  
  26.     ASL_Hail : Définie un titre au FileRequester.
  27.                ex: set ASL_Hail Selectionnez un fichier.
  28.  
  29.     ASL_LeftEdge : Définie l'emplacement du cote gauche du File
  30.                    Requester.
  31.                    ex: set ASL_LeftEdge 50
  32.  
  33.     ASL_TopEdge : Définie l'emplacement du haut du FileRequester.
  34.                   ex: set ASL_TopEdge 50
  35.  
  36.     ASL_Width : Définie la largeur du FileRequester.
  37.                 ex: set ASL_Width 300
  38.  
  39.     ASL_Height : Définie la hauteur du FileRequester.
  40.                  ex: set ASL_Height 100
  41.  
  42.     ASL_File : Définie le fichier qui doit être affiché dans le
  43.                gadget de chaine 'File' du FileRequester.
  44.                ex: set ASL_File PopUpMenu
  45.  
  46.     ASL_Dir : idem mais pour le répertoire.
  47.               ex: set ASL_Dir Df0:Devs/keymap
  48.  
  49.     ASL_Pattern : Définie le modèle permettant de filtrer certains
  50.                   fichier.
  51.                   ex: set ASL_Pattern #?.txt
  52.  
  53.     ASL_OKText : Définie le texte qui sera affiché dans le bouton
  54.                  permettant d'accepter.
  55.                  ex: set ASL_OKText Ouvrir
  56.  
  57.     ASL_CancelText : idem mais pour le bouton permettant d'annuler
  58.                      ex: set ASL_CancelText Annuler
  59.  
  60.     ASL_FuncFlags : permet d'obtenir certain effets selon la valeur
  61.                     qui est mis dans cette variable.
  62.                     1 : Rajoute un gadget de chaine contenant le
  63.                         modèle filtrant les fichiers.
  64.                     32 : Inverse les couleurs de texte et de fond,
  65.                          utilisé pour la sauvegarde d'un fichier.
  66.                     Pour avoir les 2 effets il faut ajouter les 2
  67.                     valeurs et donc mettre 33.
  68.                     ex : set ASL_FuncFlags 32
  69.  
  70.     ASL_ExtFlags1 : idem.
  71.                     1 : N'affiche dans le File Requester que les
  72.                         répertoire et enlève donc le gadget de chaine
  73.                         où se trouve le nom du fichier.
  74.                     ex : set ExtFlags1 1
  75.  
  76. III - CODE DE RETOUR
  77. ---------------------
  78.  
  79.     Les codes de retour sont les suivants:
  80.     0  : si on clique sur le bouton 'OK' ou si on double clique sur un
  81.         nom de fichier.
  82.     5  : si on clique sur le bouton de fermeture ou sur le bouton
  83.         'Cancel'.
  84.     10 : si FileReq rencontre un problème qui l'empèche de fonctionner
  85.          (par exemple une librarie introuvable ...).
  86.  
  87. IV - EXEMPLE
  88. --------------
  89.  
  90. ; Ce programme permet de choisir facilement le clavier que vous
  91. ; voulez utiliser.
  92. Set ASL_Hail Selectionnez un clavier ; on met un titre a notre
  93.                                      ; FileRequester
  94. Set ASL_Dir  DEVS:Keymaps ; on précise le chemin ou se trouve les
  95.                           ; differents clavier
  96. Set ASL_CancelText Salut! ; on modifie le gadget 'Cancel' en 'Salut!'
  97. FileReq                   ; on affiche le File Requester
  98. If WARN
  99.   ; on a cliqué sur le bouton de fermeture du File requester ou bien
  100.   ; sur le gadget 'Salut!'
  101.   Echo "Vous avez appuyé sur Salut!." ; on affiche un message
  102. Else
  103.   ; on a cliqué sur 'OK' ou bien double cliqué sur un fichier
  104.   ; et on recupère le nom du fichier dans ASL_File (variable locale)
  105.   Echo "Vous avez choisi le fichier: ${ASL_File}"
  106.   Sys:System/SetMap ${ASL_File} ; on installe le nouveau clavier
  107.   Echo "Nouveau clavier installé"
  108. EndIf
  109.  
  110. Pour toute suggestion ou pour reporter les bugs possibles ecrivez moi:
  111.  
  112.                         Mr ROUSSEAU Yannick
  113.                         23 Rue des Grouaisons
  114.                         Bat.6 Porte 604
  115.                           91290 ARPAJON
  116.  
  117.